Inside Macintosh: QuickDraw GX Graphics /

Chapter 3 - Geometric Styles / Geometric Styles Reference

Functions / Getting and Setting Joins

GXSetShapeJoin

You can use the GXSetShapeJoin function to change the join information for the style object of a particular shape.

void GXSetShapeJoin(gxShape target, const gxJoinRecord *join);

target

A reference to the shape whose join information you want to change.

join

A pointer to new join information.

DESCRIPTION

The GXSetShapeJoin function replaces the join information in the style object of the shape specified by the target parameter with the join information provided in the join parameter. You use the gxJoinRecord structure to provide join information.

Passing nil for the join parameter indicates that you want no joins and QuickDraw GX removes any join information from the target shape.

If the target shape shares its style object with other shapes, this function makes a copy of the style object, sets the target shape to reference the copy, and changes the join property of the copy. (However, if the effect of this function would leave the join information unchanged, this function does not create a copy of the style object; instead, it posts a notice.)

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
style_is_nil
parameter_out_of_range	(debugging version)
empty_shape_not_allowed	(debugging version)
ignorePlatformShape_not_allowed	(debugging version)
illegal_type_for_shape	(debugging version)
nil_style_in_glyph_not_allowed	(debugging version)
complex_glyph_style_not_allowed	(debugging version)
shapeFill_not_allowed	(debugging version)
Notices (debugging version)
join_type_already_set
tags_in_shape_ignored

SEE ALSO

For a discussion of joins, see "Joins" on page 3-25.

For examples of adding joins to shapes, see "Adding Joins to a Shape" on page 3-61 and "Adding Standard Joins to a Shape" on page 3-64.

For a discussion of the gxJoinRecord structure and a description of what types of shapes you can use as join shapes, see "The Join Structure" on page 3-101.

To retrieve join information from a style object, use the GXGetStyleJoin function, which is described on page 3-129. To specify join information for a style object, use the GXSetStyleJoin function, which is described on page 3-130.

To retrieve join information from a style object associated with a particular shape, use the GXGetShapeJoin function, which is described on page 3-132.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help